Video

Weave は自動的に moviepyを使用してビデオをログに記録します。これにより、トレース関数にビデオの入力と出力を渡すことができ、Weave はビデオデータのアップロードと保存を自動的に処理します。

ビデオサポートは現在、Pythonでのみ利用可能です。

使用の前提条件

1. インストール weave と moviepy==1.0.3。
2. W&B アカウントを作成します。

サポートされているビデオタイプ

Weave は moviepy ビデオクリップオブジェクトを認識します、例えば：

• ビデオファイルから読み込まれた VideoFileClip
• メモリ内クリップ（ ImageClip、 ColorClip、および TextClip

ファイルベースのクリップの直接アップロード

クリップが VideoFileClip で、サポートされている拡張子を持つ有効なファイル名がある場合、Weave はファイルを直接アップロードします。

サポートされているファイル拡張子：

• .mp4
• .webm
• .gif

メモリ内クリップのサポート

ビデオオブジェクトがメモリ内にある場合（ディスク上にファイルがない場合）、Weave はそれを .mp4 ファイルとしてエンコードし、アップロードを自動的に処理します。これは以下のタイプのクリップに適用されます：

• ImageClip
• ColorClip
• TextClip

Example: Trace a video function

以下のコードサンプルは、Weave でビデオ処理関数をトレースする方法を示しています。このコードサンプルは：

1. Weave プロジェクトを初期化します video-test。
2. get_video 関数を weave.op としてトラッキングし、読み込まれた VideoFileClip から1秒のサブクリップを VideoClip として抽出します。
3. クリップをアップロードし、Weave でトラッキングします。
4. MP4ビデオが見つからない場合、自動的にダミーのMP4ビデオを生成します。

スレッドセーフティの問題を避けるため、常に VideoFileClip オブジェクトへのパスを渡し、Weave op の外部で作成しないでください。

以下のコードスニペットを使用する前に、使用の前提条件を完了してください。

import os
import weave
from moviepy.editor import VideoFileClip, ColorClip, VideoClip

# Update to your project name, or create a new project named 'video-test'
weave.init('video-test')

@weave.op
def get_video(clip: VideoFileClip) -> VideoClip:
    """Process a video by path rather than by passing the clip directly.

    This ensures that the VideoFileClip is created and managed within the
    Weave op's thread context, avoiding thread-safety issues.
    """
    new_clip = clip.subclip(0, 1)
    return new_clip

if __name__ == "__main__":
    os.makedirs("videos", exist_ok=True)

    # Update the path to point to your MP4 file
    video_path = './videos/example.mp4'

    # Generate a dummy video if it doesn't exist
    # Dummy video contents: A red square that displays for 5 seconds
    if not os.path.isfile(video_path):
        print("No video found. Creating dummy video...")
        dummy_clip = ColorClip(size=(640, 480), color=(255, 0, 0), duration=5)
        dummy_clip.write_videofile(video_path, fps=24)

    clip = VideoFileClip(video_path, has_mask=False, audio=True)
    get_video(clip) 

コードサンプルが正常に実行されると、プロジェクトの Traces テーブルのリンクをクリックしてビデオを表示できます。